APPENDIX A 



Retrieve Report Template List 



Message f 


tv Parameter.:^.; i- 

•■"Name^'So.' \ 


; Parameter^ 


Required;; 


| Acceptable 
[Value 


GRTL 


Request 


Char (4) 


Yes 




pRnni IPT= 


Prrtrli ID 
rlOUUCl IU 


oriar \ i ) 


yes 


\/ r* c t u 


DATATYPE= 


Data Type 


Char (1) 


Yes 


R = Reports, 

D = Call Detail 

A = All data 
types 


DATACAT= 


Data Category 


Char(1) 


Yes 


P = Priced, 
U = Unpriced 


10= 


Inbound/Outbou 
nd 


Char (1) 


Yes 


I = Inbound, 
0 = Outbound 
B = Both 


Send Report Template List 


Message 


Parameter 
Name / 


I Parameter 

i:;Type^;:::; : -:'' N 


: Required j 


Acceptable 
Value 


SRTL 


Response 


Char (4) 


Yes 




ERR0R= 


i 

Error Code 


Char (4) 


Yes 


0 or error 


REPORTS* 


Data 


Char 


No 


See below 
formatting 



Get Report Template Detail 



Message 


Parameter 


Parameter 


Required 


Acceptable 




Name 


Type 




Value 


GRTD 


Request 


Char (4) 


Yes 




REPORTID= 


Standard Report 


Char (10) 


Yes 


Report ID (i.e., 




ID 






2,44) 



Send Report Template Detail 



Message 


Parameter 
Name 


Parameter 
Type 


Required 


Acceptable 
Value 


SRTD 


Response 


Char (4) 


Yes 




ERROR= 


Error Code 


Char (4) 


Yes 


0 or error 


ID= 


Template ID 


Char (10) 


Yes 




NODE= 


Data 


Char 




see above 
formatting 



Get User Report List 



Message 


; Parameter 
Name 


Parameter 
Type 


; Required 


Acceptable 
Value 


GURL 


Request 


Char (4) 


Yes 




USERID= 


User ID 


Char (20) 


Yes 


UserlD 


RPTTMPID= 


Report 
Template ID 


Char (10) 


Yes 


Template ID 


ENTPID= 


Enterprise ID 


Char (8) 


Yes 


Enterprise ID 


PRODUCT= 


Product ID 


Char (1 


Yes 


V.C.S.T.H 


DATACAT 


Data Category 


Char (1) 


Yes 


P = Priced 
U = Unpriced 



Send User Report List 



MesMg£ ;: '.V; v v: 


Parameter Name 


Parameter Type : 


Required 


Acceptable 
Value 


SURL 


Response 


Char (4) 


Yes 




ERROR= 


Error Gode 


Char (4) 


Yes 


0 or error 


REPORTS= 


Data 


Char 


No 


See above 
formatting 



Get User Report Detail 



Message 


Parameter 
Name 


: Parameter 
Type 


Required 


Acceptable Value 


GURD 


Request 


Char (4) 


Yes 




REPORTID= 


User Report ID 


Char (10) 


Yes 


Report ID (i.e., 245). 
Limit on unique user 
report Ids is 
2147483647 



Send User Report Detail 



Message 


Parameter 
Name 


Parameter v 
Type 


Required 


Acceptable Value 


SURD 


Response 


Char (4) 


Yes - 




ERROR= 


Error Code 


Char (4) 


Yes 


0 or error 


ID= 


Template ID 


Char(10) 


Yes 




NODE= 


Data 


Char 




see above 
formatting 



Add Report Definition 



Message 


Parameter Name 


Param 
Type 


Required 


■ Acceptable Value 


ARD 


Request 


Char (3) 


Yes 




USERID= 


User's ID 


Char (20) 


Yes 


UserlD 


ENTPID= 


Enterprise ID 


Char (8) 


Yes 


Enterprise ID - 
require 8 
characters 


STDRPTID= 


Standard Report 
ID 


Char (10) 


Yes 


Standard Report 
ID (i.e., 2, 44). 


NAME= 


User's report 
name 


Char(100) 


Yes 


User's designated 
name for this 
report (e.g., My 
Longest Calls) 


PRODUCT= 


Product 


Char (1) 


Yes 


Vnet = V, CVNS = 
C, Vision = S, Toll 
Free = T, 
Broadband = H 


CATEGORY= 


Report category 
Description 


Char 


Yes 


Examples are: . 
Analyze Traffic, 
Standard Report, 
Telecommunicatio 
ns 



Add Report Definition 



Message Parameter Name Param Required Acceptable Value 
• • •■ • : •■ Type . • ■.; ' ■ ■ ,: •■. : 



THRESHOLD 


Record limits 


Delimiter 


No 


holds 

RECCOUNT, 
RANKING, 
DURATION, ANI 


RECCOUNT 


Record count 


Char (4) 


Yes 


Maximum amount 
of records to be 
returned in the 
report results. If no 
threshold is 
received, the 
threshold for the 
standard report will 
be used. 


RANKING= 


TVS Ranking 


Char (3) 


No 


# of call ranks to 
show. If ranking is 
not passed, the 
default value will 
be used. 


DURATION^ 


TVS Duration 


Char (4) 


No 


# for call duration 
threshold. If 
duration is not 
passed, the default 
value will be used. 


ANN 


TVS ANI 


Char (3) 


No 


# of Items in Most 
Frequent report. If 
ANI is not passed, 
the default value 
will be used. 


SCHEDULE= 


Report schedule 


Char () 


No 


If scheduling 
information is not 
received, the 
Report Manager 
will only store the 
report. It will not 
send a request to 
the fulfilling server. 
No overlapping 
dates will be sent 
in the start/end 
pairs. 

A = Adhoc, H = 
Hourly, D = Daily, 
W= Weekly, M = 
Monthly 



Add Report Definition 



Message f 


Parameter Name 


Param 
Type 


Required 


Acceptable Value | 


START= 


Start report 
schedule 


Char (12) 


No 


YYYYMMDDhhm 
m 

This parameter is 
only used if the 
report is Adhoc. 
There can be 
multiple start and 
end dates. 


END= 


End report 
schedule 


Char (12) 


No 


YYYYMMDDhhm 
m 

This parameter is 

nnl\/ iiqpH if thp 

report is Adhoc. 
There can be 
multiple start and 
end dates. 


RANGETYPE 


Range type picked 
hv the user 

Uy 11 iv uwvi 


Char(1) 


Yes if 
Adhoc 


1 = range 
0 = discreet 


SCHEDTYPE 


Schedule Type 
picked by the user 


Char(1) 


Yes 


A = Adhoc only 
R = Recurring only 


TIMEZONE= 


User's time zone 
• 


Char (3) 


Yes 


User's time zone 
value as received . 
from StarOE 


NDIALED= 


Filter 


Char 


Yes for 
TVS, No for 
all others 


Number range 
delimited by ~ 




nici aiK^My 


Char 


Yes for 
ODS, and 
TVS 

outbound. 
No for all 
others 


Single or multiple 
values from billing 
hierarchy. Must at 
least include the 
Corp ID 


CARDNO 


Card number 


Char 


No 


Single or multiple 
values 


IDAC= 


ID/Account Codes 


Char 


No 


Single or multiple 
values 


GEO= 


Geographical 


Char 


No 


Single or multiple 
values from 
geographical 
hierarchy. 


IACCESS= 


Inbound Access 


Char 


No 


Single or multiple 
values of inbound 
access 

codes(Example: 7) 



Add Report Definition 



Message F 


Parameter Name 


Param : 1 
Type 


Required 


Acceptable Value | 


OACCESS= 


Outbound Access 


Char 


No 


Single or multiple 
values of outbound 
access codes 

(Example: 4) 


IDISTRANGE 


nbound Distance 
Range 


Char 


No 


Single or multiple 
values of inbound 
distance ranges 
codes(Examp!e: 2) 


IUSAGE= 


nbound Usage 


Char 


No 


Single or multiple 
values of inbound 
usage (Examle: 5) 


ODISTRANG 
E= 


Outbound 
Distance Range 


Char 


No 


Single or multiple 
values of outbound 
distance ranges ( 
Example: A) 


OUSAGE= 


Outbound Usage 


Char 


No 


Single or multiple 
values of outbound 
usage ( 
Example:2) I 


SORTBY= 


Sort Order 
i 


Char 


No 


If sort order is not 
received, sort 
order for standard 
report will be used. 
If sort order is 
passed, it must be 
a column ID and 
descendina or 
ascending order 
(i.e., 1A). 


DESCRIPTIO 
N= 


Description 


Char 


No 


user's report 
description. If no 
description is 
received, the 
description for the 
standard report will 
be used. 


COLUMNS= 


Columns 


Char 


No 


These are the 
columns the user 
wants in their 
report. Field Ids 
are to be passed 
here (i.e., 5-17- 
23-44). Use 
default if not 
passed. 


ACTIVE= 


Indicates whether 
or not the report is 
scheduled 


Char (1) 


No 


Save only = 0, 
Schedule = 1,0 is 
the default. 



Add Report Definition 



Message 1 


Parameter Name 


Param 
Type 


Required 


Acceptable Value 1 


DURRANGE 


Duration Range 


Char 


No 


oingje or muwpie 
values from the 
duration pick list 


TOTALMOD 
E= 


Totals or subtotals 
required based on 
user selection 


Char(1) 


No 


0 = None (default), 

1 = Subtotal, 2 = 
Total 3 = Both. 


SUBTOTCOL 


Indicates which 
columns the user 
wants subtotals on 


L*nar 


Yp<; if 
TOTALMO 
DE is 1 or 3. 


Columns to be 
subtotaled 


MMADDR= 


Email address 


Char(75)' 


No 


Text 


MMTEXT= 


Message 


onar^ouu; 


Nn 


Text 


PGT= 


Pager System 


Char(15) 


No 


Pager System 


PGPin= 


Pager Pin 


Char(8) 


No 


Pin Number 


PGTxt= 


Message 


\Jl ICll ' v J 


No 


Text 


EMAIL= 


Indicates if user 
picked email. 


Char(1) 


Yes 


0 = no, 1 = yes 


PAGE= 


Indicates if User 
picked page 


Char(1) 


Yes 


0 = no, 1 = yes 


LANG= 


Indicates the 
language a user 
picked. ' 


Char(4) 


No 


Default will be 
American English, 
the values are not 
defined. 


CURR= 


Indicates the 
language a user 
picked 


Char(4) 


No 


Default will be 
American Dollar, 
the values are not 
defined. 



Add Report Definition Acknowledgment 



Message 


Parameter 
Name 


Param 
Type 


Required ". 


Acceptable 
Value 


ARDA 


Response 


Char (4) 


Yes 




ERROR= 


Error Code: 


Char (4) 


Yes 


0 or error 


USERRPTID 


User ReportID 


Char (10) 


No 


User Report ID 
(i.e., 245). Limit 
on unique user 
report Ids is 
2147483647. 



1 



Delete Report Definition 



Message 


Parameter 
Name 


ParamType ; 


Required 


Acceptable Value 


DRD 


Request 


Char (3) 


Yes 




USERID= 


User's ID 


Char (20) 


Yes 


UserlD 


USERRPTID 


User Report ID 


Char (10) 


Yes 


User Report ID (i.e., 
245). Limit on unique 
user report Ids is 
2147483647 


Delete Report D< 


jfinition Acknowledgment 


Message 


Parameter 
Name ^ 


ParamType 


■ 


Required 


Acceptable Value 


DRDA 


Response 


Char (4) 


Yes 




ERROR= 


Error Code 


Char (4) 


Yes 


0 or error 


USERRPTID 


User Report ID 


Char (10) 


No 


User Report ID (i.e., 
245). Limit on unique 
user report Ids is 
2147483647 



Copy Report Definition 



Message 


Parameter 
Name 


Parameter Type ; 


Required 


Acceptable 
Value 


CRD 


Request 


Char (3) 


Yes 




USERRPTID = 


User Report ID 


Char (10) 


No 


User Report ID 
(i.e., 245). 
Limit on unique 
user report Ids 
is 2147483647 


NAME= 


User report name 


Char (50) 


Yes 


User report 
name 



r t 



1 



Copy Report Definition Acknowledgment 



Message 


Parameter 
Name 


Parameter Type 


Required 


Acceptable 
Value 


CRDA 


Response 


Char (4) 


Yes 




ERROR= 


Error Code 


Char (4) 


Yes 


0 or error 


USERRPTID - 


User Report ID 


Char (10) 


No 


User Report ID 
(i.e., 245). 
Limit on unique 
user report Ids 
is 2147483647 



Update Report Status 



Message 


Parameter - 

■Name\-K^ : v V 


Pararri 
Type •' 


Required : 


Acceptable Value 


URS 


Request 


Char (3) 


Yes 




USERRPTID 


User Report ID 


Char (10) 


No 


User Report ID 
(i.e., 245). Limit on 
unique user report 
Ids is 2147483647 


ACTIVE 


User Active 


Char(1) 


Yes 


0 - for saved/not 
scheduled 

1 - for scheduled 



Update Report Scheduling Acknowledgment 



Message 


Parameter 
Name 


Parameter Type '] 


Required 


Acceptable 
Value 


URSA 


Response 


Char (4) 


Yes 




ERROR* 


Error Code 


Char (4) 


Yes 


0 or error 


USERRPTID = 


User Report ID 


Char (10) 


No 


User Report ID 
(i.e., 245). 
Limit on unique 
user report Ids 
is 2147483647 



1 



Get Pick List - Access 



Message 


Parameter 
Name 


Parameter Type 


Required 


Acceptable 1 
Value | 


GPL 


Request 


cnar (c) 


I CO 




PL ACCESS= 


Pick List Type 


Character 


Yes 


PL_ACCESS 


10= 


Inbound/Outboun 

□ 


Char (1) 


Yes 


Mnbound, 
O=0utbound, 


PR0DUCT= 


Product 


Char(1) 


Yes 


T=Toll Free, V 
= Vnet, S = 
Vision, C = 
CVNS, H = 
Broadband 


DATACAT= 


Data Category 


Char(1) 


Yes 


U = Unpriced, 
P = Priced, 
B = Both 


Get Pick List Ackn< 


awledgement - Access 


Message 


Parameter 
; Name 


Parameter Type 


Required 


Acceptable 
Value 


GPLA 


Response 


Char (4) 


Yes 




ERR0R= 


Error Code 


Char (4) 


Yes 


0 or error 


PL_ACCESS= 


Pick List Type 


Character 


Yes 


Access code, 
Description 


Get Pick List -Fie] 


Ids 


1 Message 


: Parameter 
i Name 


: Parameter Type 


Required 


; Acceptable 
! Value 


GPL 


Response 


Char (3) 


Yes 




PL_FIELDS 


Pick List Type 


Character 


Yes 


PL_FIELDS 


RPTTMPID= 


Report Template 
ID 


Char (10) 


Yes 





9 < 



Get Pick List Acknowledgement - Fields 



Message 


Parameter 
Name 


Parameter Type 


Required 


Acceptable 
Value 


GPLA 


Response 


Char (4) 


Yes 




ERROR= 


Error Code 


Char (4) 


Yes 


0 or error 


PL_FIELDS= 


Pick List Type 


Character 


Yes 


FieldiD, 
FieldHeader, 
FieldCoIumnHi 
de, FieldSort 



Get Pick List - Duration 



Message 


Parameter 


Parameter Type 


Required 


Acceptable 


Name 






Value 


GPL 


Response 


Char (3) 


Yes 


Single or 








Multiple Values 


PL_DURATION 


Pick List Type 


Character 


Yes 


PL_DU RATION 



Get Pick List Acknowledgement - Duration 



Message 


Parameter 
Name 


Parameter Type 


Required 


Acceptable 
Value 


GPLA 


Response 


Char (4) 


Yes 


Single or 


ERROR= 


Error Code 


Char (4) 


Yes 


0 or error 


PL_DURATION= 


Pick List Type 


Character 


Yes 


Duration 


example 











Get Pick List - Time Zone 



Message 


Parameter 


Parameter Type 


Required 


Acceptable 


Name 






Value 


GPL 


Response 


Char (3) 


Yes 




PL_TIMEZONE 


Pick List Type 


Character 


Yes 


PL_TIMEZONE 



Get Pick List Acknowledgement - Time Zone 



Message 


Parameter 
Name 


Parameter Type 


Required 


Acceptable 
Value 


GPLA 


Response 


Char (4) 


Yes 




ERROR= 


Error Code 


Char (4) 


Yes 


0 or error 


PL_TIMEZONE= 


Pick List Type 


Character 


Yes 


TimeZoneCode 
, Description 


Get Pick List - Billing Hierarchy 


Message 


Parameter 
Name 


•. Parameter Type 


Required 


Acceptable 
Value 


GPL 


Response 


Char (3) 


Yes 




PLJHIER 


Pick List Type 


Character 


Yes 


PL_HIER 


USERRPTID= 


User Report ID 


Char (10) 


Yes 


User report ID 



•1 

Get Pick List Acknowledgement - Billing Hierarchy 



Message 


Parameter- 
Name 


Parameter Type 


Required 


Acceptable 1 
Value | 


GPLA 


Response 


Char (4) 


Yes 




ERROR= 


Error Code 


Char (4) 


Yes 


0 or error 


PL_HIER- 


Pick List Type 


Character 


Yes 


hierarchy data 


Get Pick List -Geo 


graphical Hierarchy 


Message 


Parameter 
Name 


Parameter Type 


Required 


Acceptable 
Value 


GPL 


Response 


Char (3) 


Yes 




PL GEO 


Pick List Type 


Character 


Yes 


PL_GEO 


USERRPTID= 


User Report ID 


Char (10) 


Yes 


User report ID 


Get Pick List Ackn 


owledgement - Geographical Hierarchy 


1 Message 


Parameter 
Name 


Parameter Type 


Required 


Acceptable 
Value 


GPLA 


Response 


Char (4) 


Yes 




ERROR= 


Error Code 


Char (4) 


Yes 


0 or error 


PL_GEO 


Pick List Type 


Character 


Yes 


geo data 



Get Pick List - Static Range 



Message 


Parameter 
Name 


Parameter Type 


Required 


Acceptable 
Value 


GPL 


Response 


Char (3) 


Yes 




ERROR= 


Error Code 


Char (4) 


Yes 


0 or error 


PL_RANGE 


Pick List Type 


Character 


Yes 


PL_RANGE 


10= 


Inbound/Outboun 

A 

u 


Char(1) 


Yes 


Mnbound, 
O=0utbound, 


PR0DUCT= 


Product 


Char(1) 


Yes 


T=Toll Free, V 
= Vnet, S = 
Vision, C = 
CVNS,H = 
Broadband 


DATACAT= 


Data Category 


Char (1) 


Yes 


U = Unpriced, 
P = Priced, 
B = Both 


Get Pick List Acknowledgment - Static Range 


Message 


Parameter 
Name 


Parameter Type 

" , - 


Required ■'. 


Acceptable 
Value 


GPLA 


Response 


Char (4) 


Yes 




ERROR= 


Error Code 


Char (4) 


Yes 


0 or error 


PL_RANGE= 


Pick List Type 


Character 


Yes 


range code, 
description 


Get Pick List - Static Usage 


Message 


Parameter 
Name 


Parameter Type 


Required 


Acceptable 
Value 


GPL 


Response - 


Char (3) 


Yes 




ERROR= 


Error Code 


Char (4) 


Yes 


0 or error 


PL_USAGE 


Pick List Type 


Character 


Yes 


PLJJSAGE 


10= 


Inbound/Outboun 
d 


Char(1) 


Yes 


Mnbound, 
OOutbound, 


PRODUCT* 


Product 


Char (1) 


Yes 


T-Toll Free, V 
= Vnet, S = 
Vision, C = 
CVNS, H = 
Broadband 


DATACAT= 


Data Category 


Char(1) 


Yes 


U = Unpriced, 
P = Priced, 
B = Both 



Get Pick List Acknowledgment - Static Usage 



Message 


Parameter 


Parameter Type 


Required 


Acceptable 


Name 






Value 


GPLA 


Response 


Char (4) 


Yes 




ERROR= 


Error Code 


Char (4) 


Yes 


0 or error 


PL_USAGE= 


Pick List Type 


Character 


Yes 


usage code, 










description 


Get Pick List - Language 


Message 


Parameter 


Parameter Type 


Required 


Acceptable 


Name 




Value 



GPL 



Response 



Char (4) 



Yes 



ERROR= 



Error Code 



Char (4) 



Yes 



0 or error 



PL_LANG= 



Pick List Type 



Character 



Yes 



Language code 



Get Pick List Acknowledgment -Language 



Message 


Parameter 
Name 


Parameter Type 


Required 


Acceptable 
Value 


GPLA 


Response 


Char (4) 


Yes 




ERROR= 


Error Code 


Char (4) 


Yes 


0 or error 


PL_LANG= 


Pick List Type 


Character 


Yes 


Row 

information to 
follow 


Get Pick List - Currency 


Message 


Parameter 
Name 


Parameter Type 


Required 


Acceptable 
Value 


GPL 


Response 


Char (4) 


Yes 




ERROR= 


Error Code 


Char (4) 


Yes 


0 or error 


PL_CURR= 


Pick List Type 


Character 


Yes 


Currency code 



Get Pick List Acknowledgment -Currency 



Message 


Parameter 
Name 


Parameter Type 


Required 


Acceptable 
Value 


GPLA 


Response 


Char (4) 


Yes 




ERROR* 


Error Code 


Char (4) 


Yes 


0 or error 


PU_CURR= 


Pick List Type 


Character 


Yes 


Row 

information to 
follow 



